<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>find_text [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_ocr.html">OCR</a> / <a href="toc_ocr_segmentation.html">分割</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">find_text</span><span data-if="c" style="display:none;">T_find_text</span><span data-if="cpp" style="display:none;">FindText</span><span data-if="dotnet" style="display:none;">FindText</span><span data-if="python" style="display:none;">find_text</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">find_text</span><span data-if="c" style="display:none;">T_find_text</span><span data-if="cpp" style="display:none;">FindText</span><span data-if="dotnet" style="display:none;">FindText</span><span data-if="python" style="display:none;">find_text</span></code> — Find text in an image.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>find_text</b>(<a href="#Image"><i>Image</i></a> :  : <a href="#TextModel"><i>TextModel</i></a> : <a href="#TextResultID"><i>TextResultID</i></a>)</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_find_text</b>(const Hobject <a href="#Image"><i>Image</i></a>, const Htuple <a href="#TextModel"><i>TextModel</i></a>, Htuple* <a href="#TextResultID"><i>TextResultID</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>FindText</b>(const HObject&amp; <a href="#Image"><i>Image</i></a>, const HTuple&amp; <a href="#TextModel"><i>TextModel</i></a>, HTuple* <a href="#TextResultID"><i>TextResultID</i></a>)</code></p>
<p>
<code><a href="HTextResult.html">HTextResult</a> <a href="HImage.html">HImage</a>::<b>FindText</b>(const HTextModel&amp; <a href="#TextModel"><i>TextModel</i></a>) const</code></p>
<p>
<code><a href="HTextResult.html">HTextResult</a> <a href="HTextModel.html">HTextModel</a>::<b>FindText</b>(const HImage&amp; <a href="#Image"><i>Image</i></a>) const</code></p>
<p>
<code>void <a href="HTextResult.html">HTextResult</a>::<b>HTextResult</b>(const HImage&amp; <a href="#Image"><i>Image</i></a>, const HTextModel&amp; <a href="#TextModel"><i>TextModel</i></a>)</code></p>
<p>
<code>void <a href="HTextResult.html">HTextResult</a>::<b>FindText</b>(const HImage&amp; <a href="#Image"><i>Image</i></a>, const HTextModel&amp; <a href="#TextModel"><i>TextModel</i></a>)</code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>FindText</b>(<a href="HObject.html">HObject</a> <a href="#Image"><i>image</i></a>, <a href="HTuple.html">HTuple</a> <a href="#TextModel"><i>textModel</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#TextResultID"><i>textResultID</i></a>)</code></p>
<p>
<code><a href="HTextResult.html">HTextResult</a> <a href="HImage.html">HImage</a>.<b>FindText</b>(<a href="HTextModel.html">HTextModel</a> <a href="#TextModel"><i>textModel</i></a>)</code></p>
<p>
<code><a href="HTextResult.html">HTextResult</a> <a href="HTextModel.html">HTextModel</a>.<b>FindText</b>(<a href="HImage.html">HImage</a> <a href="#Image"><i>image</i></a>)</code></p>
<p>
<code>public <a href="HTextResult.html">HTextResult</a>(<a href="HImage.html">HImage</a> <a href="#Image"><i>image</i></a>, <a href="HTextModel.html">HTextModel</a> <a href="#TextModel"><i>textModel</i></a>)</code></p>
<p>
<code>void <a href="HTextResult.html">HTextResult</a>.<b>FindText</b>(<a href="HImage.html">HImage</a> <a href="#Image"><i>image</i></a>, <a href="HTextModel.html">HTextModel</a> <a href="#TextModel"><i>textModel</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>find_text</b>(<a href="#Image"><i>image</i></a>: HObject, <a href="#TextModel"><i>text_model</i></a>: HHandle) -&gt; HHandle</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">find_text</span><span data-if="c" style="display:none">find_text</span><span data-if="cpp" style="display:none">FindText</span><span data-if="com" style="display:none">FindText</span><span data-if="dotnet" style="display:none">FindText</span><span data-if="python" style="display:none">find_text</span></code> finds text specified by the <a href="#TextModel"><i><code><span data-if="hdevelop" style="display:inline">TextModel</span><span data-if="c" style="display:none">TextModel</span><span data-if="cpp" style="display:none">TextModel</span><span data-if="com" style="display:none">TextModel</span><span data-if="dotnet" style="display:none">textModel</span><span data-if="python" style="display:none">text_model</span></code></i></a> in the
<a href="#Image"><i><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></i></a> and returns the result in <a href="#TextResultID"><i><code><span data-if="hdevelop" style="display:inline">TextResultID</span><span data-if="c" style="display:none">TextResultID</span><span data-if="cpp" style="display:none">TextResultID</span><span data-if="com" style="display:none">TextResultID</span><span data-if="dotnet" style="display:none">textResultID</span><span data-if="python" style="display:none">text_result_id</span></code></i></a>.
Specific results of <a href="#TextResultID"><i><code><span data-if="hdevelop" style="display:inline">TextResultID</span><span data-if="c" style="display:none">TextResultID</span><span data-if="cpp" style="display:none">TextResultID</span><span data-if="com" style="display:none">TextResultID</span><span data-if="dotnet" style="display:none">textResultID</span><span data-if="python" style="display:none">text_result_id</span></code></i></a> can be obtained with
<a href="get_text_result.html"><code><span data-if="hdevelop" style="display:inline">get_text_result</span><span data-if="c" style="display:none">get_text_result</span><span data-if="cpp" style="display:none">GetTextResult</span><span data-if="com" style="display:none">GetTextResult</span><span data-if="dotnet" style="display:none">GetTextResult</span><span data-if="python" style="display:none">get_text_result</span></code></a> and <a href="get_text_object.html"><code><span data-if="hdevelop" style="display:inline">get_text_object</span><span data-if="c" style="display:none">get_text_object</span><span data-if="cpp" style="display:none">GetTextObject</span><span data-if="com" style="display:none">GetTextObject</span><span data-if="dotnet" style="display:none">GetTextObject</span><span data-if="python" style="display:none">get_text_object</span></code></a>.
</p>
<p>The text results in <a href="#TextResultID"><i><code><span data-if="hdevelop" style="display:inline">TextResultID</span><span data-if="c" style="display:none">TextResultID</span><span data-if="cpp" style="display:none">TextResultID</span><span data-if="com" style="display:none">TextResultID</span><span data-if="dotnet" style="display:none">textResultID</span><span data-if="python" style="display:none">text_result_id</span></code></i></a> differ, depending on how
<code><span data-if="hdevelop" style="display:inline">Mode</span><span data-if="c" style="display:none">Mode</span><span data-if="cpp" style="display:none">Mode</span><span data-if="com" style="display:none">Mode</span><span data-if="dotnet" style="display:none">mode</span><span data-if="python" style="display:none">mode</span></code> was set when creating the <a href="#TextModel"><i><code><span data-if="hdevelop" style="display:inline">TextModel</span><span data-if="c" style="display:none">TextModel</span><span data-if="cpp" style="display:none">TextModel</span><span data-if="com" style="display:none">TextModel</span><span data-if="dotnet" style="display:none">textModel</span><span data-if="python" style="display:none">text_model</span></code></i></a> with
<a href="create_text_model_reader.html"><code><span data-if="hdevelop" style="display:inline">create_text_model_reader</span><span data-if="c" style="display:none">create_text_model_reader</span><span data-if="cpp" style="display:none">CreateTextModelReader</span><span data-if="com" style="display:none">CreateTextModelReader</span><span data-if="dotnet" style="display:none">CreateTextModelReader</span><span data-if="python" style="display:none">create_text_model_reader</span></code></a>.
</p>
<p>For a text model with <code><span data-if="hdevelop" style="display:inline">Mode</span><span data-if="c" style="display:none">Mode</span><span data-if="cpp" style="display:none">Mode</span><span data-if="com" style="display:none">Mode</span><span data-if="dotnet" style="display:none">mode</span><span data-if="python" style="display:none">mode</span></code> = <i><span data-if="hdevelop" style="display:inline">'auto'</span><span data-if="c" style="display:none">"auto"</span><span data-if="cpp" style="display:none">"auto"</span><span data-if="com" style="display:none">"auto"</span><span data-if="dotnet" style="display:none">"auto"</span><span data-if="python" style="display:none">"auto"</span></i> <code><span data-if="hdevelop" style="display:inline">find_text</span><span data-if="c" style="display:none">find_text</span><span data-if="cpp" style="display:none">FindText</span><span data-if="com" style="display:none">FindText</span><span data-if="dotnet" style="display:none">FindText</span><span data-if="python" style="display:none">find_text</span></code>
extracts and classifies text of arbitrary size within the <a href="#Image"><i><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></i></a>.
It is possible to restrict the search to characters with specific
attributes, see <a href="set_text_model_param.html"><code><span data-if="hdevelop" style="display:inline">set_text_model_param</span><span data-if="c" style="display:none">set_text_model_param</span><span data-if="cpp" style="display:none">SetTextModelParam</span><span data-if="com" style="display:none">SetTextModelParam</span><span data-if="dotnet" style="display:none">SetTextModelParam</span><span data-if="python" style="display:none">set_text_model_param</span></code></a> for details.
</p>
<p>For a text model with <code><span data-if="hdevelop" style="display:inline">Mode</span><span data-if="c" style="display:none">Mode</span><span data-if="cpp" style="display:none">Mode</span><span data-if="com" style="display:none">Mode</span><span data-if="dotnet" style="display:none">mode</span><span data-if="python" style="display:none">mode</span></code> = <i><span data-if="hdevelop" style="display:inline">'manual'</span><span data-if="c" style="display:none">"manual"</span><span data-if="cpp" style="display:none">"manual"</span><span data-if="com" style="display:none">"manual"</span><span data-if="dotnet" style="display:none">"manual"</span><span data-if="python" style="display:none">"manual"</span></i> reasonable
parameters for the text model, including the expected character height and
width, need to be set using <a href="set_text_model_param.html"><code><span data-if="hdevelop" style="display:inline">set_text_model_param</span><span data-if="c" style="display:none">set_text_model_param</span><span data-if="cpp" style="display:none">SetTextModelParam</span><span data-if="com" style="display:none">SetTextModelParam</span><span data-if="dotnet" style="display:none">SetTextModelParam</span><span data-if="python" style="display:none">set_text_model_param</span></code></a>.
Furthermore, the <a href="#Image"><i><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></i></a> is preprocessed such that character like
structures are enhanced. The resulting compensated image can be queried from
<a href="#TextResultID"><i><code><span data-if="hdevelop" style="display:inline">TextResultID</span><span data-if="c" style="display:none">TextResultID</span><span data-if="cpp" style="display:none">TextResultID</span><span data-if="com" style="display:none">TextResultID</span><span data-if="dotnet" style="display:none">textResultID</span><span data-if="python" style="display:none">text_result_id</span></code></i></a> if <i><span data-if="hdevelop" style="display:inline">'persistence'</span><span data-if="c" style="display:none">"persistence"</span><span data-if="cpp" style="display:none">"persistence"</span><span data-if="com" style="display:none">"persistence"</span><span data-if="dotnet" style="display:none">"persistence"</span><span data-if="python" style="display:none">"persistence"</span></i> was set to <i><span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></i> in
<a href="#TextModel"><i><code><span data-if="hdevelop" style="display:inline">TextModel</span><span data-if="c" style="display:none">TextModel</span><span data-if="cpp" style="display:none">TextModel</span><span data-if="com" style="display:none">TextModel</span><span data-if="dotnet" style="display:none">textModel</span><span data-if="python" style="display:none">text_model</span></code></i></a>.
</p>
<p>Both the text models with <code><span data-if="hdevelop" style="display:inline">Mode</span><span data-if="c" style="display:none">Mode</span><span data-if="cpp" style="display:none">Mode</span><span data-if="com" style="display:none">Mode</span><span data-if="dotnet" style="display:none">mode</span><span data-if="python" style="display:none">mode</span></code> = <i><span data-if="hdevelop" style="display:inline">'auto'</span><span data-if="c" style="display:none">"auto"</span><span data-if="cpp" style="display:none">"auto"</span><span data-if="com" style="display:none">"auto"</span><span data-if="dotnet" style="display:none">"auto"</span><span data-if="python" style="display:none">"auto"</span></i> and
<code><span data-if="hdevelop" style="display:inline">Mode</span><span data-if="c" style="display:none">Mode</span><span data-if="cpp" style="display:none">Mode</span><span data-if="com" style="display:none">Mode</span><span data-if="dotnet" style="display:none">mode</span><span data-if="python" style="display:none">mode</span></code> = <i><span data-if="hdevelop" style="display:inline">'manual'</span><span data-if="c" style="display:none">"manual"</span><span data-if="cpp" style="display:none">"manual"</span><span data-if="com" style="display:none">"manual"</span><span data-if="dotnet" style="display:none">"manual"</span><span data-if="python" style="display:none">"manual"</span></i> apply various thresholds to the input
image and segment character candidates based on region and gray value
features. These candidates are further clustered to lines. Each line is
individually completed and tested if it fulfills the constraints of a text
line. Text models with <code><span data-if="hdevelop" style="display:inline">Mode</span><span data-if="c" style="display:none">Mode</span><span data-if="cpp" style="display:none">Mode</span><span data-if="com" style="display:none">Mode</span><span data-if="dotnet" style="display:none">mode</span><span data-if="python" style="display:none">mode</span></code> set to <i><span data-if="hdevelop" style="display:inline">'auto'</span><span data-if="c" style="display:none">"auto"</span><span data-if="cpp" style="display:none">"auto"</span><span data-if="com" style="display:none">"auto"</span><span data-if="dotnet" style="display:none">"auto"</span><span data-if="python" style="display:none">"auto"</span></i> require a text
line to consist of at least two characters, whereas text models with
<code><span data-if="hdevelop" style="display:inline">Mode</span><span data-if="c" style="display:none">Mode</span><span data-if="cpp" style="display:none">Mode</span><span data-if="com" style="display:none">Mode</span><span data-if="dotnet" style="display:none">mode</span><span data-if="python" style="display:none">mode</span></code> set to <i><span data-if="hdevelop" style="display:inline">'manual'</span><span data-if="c" style="display:none">"manual"</span><span data-if="cpp" style="display:none">"manual"</span><span data-if="com" style="display:none">"manual"</span><span data-if="dotnet" style="display:none">"manual"</span><span data-if="python" style="display:none">"manual"</span></i> require a text line to consist of at
least three characters. In a further step, punctuations and separators are
added if the correspondent parameters were set via
<a href="set_text_model_param.html"><code><span data-if="hdevelop" style="display:inline">set_text_model_param</span><span data-if="c" style="display:none">set_text_model_param</span><span data-if="cpp" style="display:none">SetTextModelParam</span><span data-if="com" style="display:none">SetTextModelParam</span><span data-if="dotnet" style="display:none">SetTextModelParam</span><span data-if="python" style="display:none">set_text_model_param</span></code></a>. Finally, if <a href="#TextModel"><i><code><span data-if="hdevelop" style="display:inline">TextModel</span><span data-if="c" style="display:none">TextModel</span><span data-if="cpp" style="display:none">TextModel</span><span data-if="com" style="display:none">TextModel</span><span data-if="dotnet" style="display:none">textModel</span><span data-if="python" style="display:none">text_model</span></code></i></a> contains
<i><span data-if="hdevelop" style="display:inline">'text_line_structure'</span><span data-if="c" style="display:none">"text_line_structure"</span><span data-if="cpp" style="display:none">"text_line_structure"</span><span data-if="com" style="display:none">"text_line_structure"</span><span data-if="dotnet" style="display:none">"text_line_structure"</span><span data-if="python" style="display:none">"text_line_structure"</span></i> entries, the completed line is fitted to
these structures.
</p>
<p><code><span data-if="hdevelop" style="display:inline">find_text</span><span data-if="c" style="display:none">find_text</span><span data-if="cpp" style="display:none">FindText</span><span data-if="com" style="display:none">FindText</span><span data-if="dotnet" style="display:none">FindText</span><span data-if="python" style="display:none">find_text</span></code> finds text which is roughly horizontally aligned
in <a href="#Image"><i><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></i></a>. <a href="text_line_orientation.html"><code><span data-if="hdevelop" style="display:inline">text_line_orientation</span><span data-if="c" style="display:none">text_line_orientation</span><span data-if="cpp" style="display:none">TextLineOrientation</span><span data-if="com" style="display:none">TextLineOrientation</span><span data-if="dotnet" style="display:none">TextLineOrientation</span><span data-if="python" style="display:none">text_line_orientation</span></code></a> and <a href="rotate_image.html"><code><span data-if="hdevelop" style="display:inline">rotate_image</span><span data-if="c" style="display:none">rotate_image</span><span data-if="cpp" style="display:none">RotateImage</span><span data-if="com" style="display:none">RotateImage</span><span data-if="dotnet" style="display:none">RotateImage</span><span data-if="python" style="display:none">rotate_image</span></code></a>
can be used to achieve this alignment.
</p>
<p>Since memory is allocated for the text result during the call of
<code><span data-if="hdevelop" style="display:inline">find_text</span><span data-if="c" style="display:none">find_text</span><span data-if="cpp" style="display:none">FindText</span><span data-if="com" style="display:none">FindText</span><span data-if="dotnet" style="display:none">FindText</span><span data-if="python" style="display:none">find_text</span></code> and during the following operations, the text result
should be
freed explicitly by 该算子 <a href="clear_text_result.html"><code><span data-if="hdevelop" style="display:inline">clear_text_result</span><span data-if="c" style="display:none">clear_text_result</span><span data-if="cpp" style="display:none">ClearTextResult</span><span data-if="com" style="display:none">ClearTextResult</span><span data-if="dotnet" style="display:none">ClearTextResult</span><span data-if="python" style="display:none">clear_text_result</span></code></a> as soon as it is
no longer used.  </p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  
    <li>Automatically parallelized on internal data level.</li>
  
</ul>
<p>This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.</p>
<p>This operator supports canceling timeouts and interrupts.</p>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Image" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></b> (input_object)  </span><span>singlechannelimage <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject</span> (byte / uint2)</span>
</div>
<p class="pardesc">Input image.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="TextModel" class="parname"><b><code><span data-if="hdevelop" style="display:inline">TextModel</span><span data-if="c" style="display:none">TextModel</span><span data-if="cpp" style="display:none">TextModel</span><span data-if="com" style="display:none">TextModel</span><span data-if="dotnet" style="display:none">textModel</span><span data-if="python" style="display:none">text_model</span></code></b> (input_control)  </span><span>text_model <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTextModel.html">HTextModel</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">HHandle</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">Text model specifying the text to be segmented.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="TextResultID" class="parname"><b><code><span data-if="hdevelop" style="display:inline">TextResultID</span><span data-if="c" style="display:none">TextResultID</span><span data-if="cpp" style="display:none">TextResultID</span><span data-if="com" style="display:none">TextResultID</span><span data-if="dotnet" style="display:none">textResultID</span><span data-if="python" style="display:none">text_result_id</span></code></b> (output_control)  </span><span>text_result <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTextResult.html">HTextResult</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">HHandle</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">Result of the segmentation.</p>
</div>
<h2 id="sec_example_all">例程 (HDevelop)</h2>
<pre class="example">
read_image (Image, 'numbers_scale')
create_text_model_reader ('auto', 'Document_Rej.omc', TextModel)
* Optionally specify text properties
set_text_model_param (TextModel, 'min_char_height', 20)
find_text (Image, TextModel, TextResultID)
* Return character regions and corresponding classification results
get_text_object (Characters, TextResultID, 'all_lines')
get_text_result (TextResultID, 'class', Class)
</pre>
<h2 id="sec_result">结果</h2>
<p>如果参数均有效，算子
<code><span data-if="hdevelop" style="display:inline">find_text</span><span data-if="c" style="display:none">find_text</span><span data-if="cpp" style="display:none">FindText</span><span data-if="com" style="display:none">FindText</span><span data-if="dotnet" style="display:none">FindText</span><span data-if="python" style="display:none">find_text</span></code> 返回值 <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
    . If
necessary, an exception is raised.</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="create_text_model_reader.html"><span data-if="hdevelop" style="display:inline">create_text_model_reader</span><span data-if="c" style="display:none">create_text_model_reader</span><span data-if="cpp" style="display:none">CreateTextModelReader</span><span data-if="com" style="display:none">CreateTextModelReader</span><span data-if="dotnet" style="display:none">CreateTextModelReader</span><span data-if="python" style="display:none">create_text_model_reader</span></a></code>, 
<code><a href="set_text_model_param.html"><span data-if="hdevelop" style="display:inline">set_text_model_param</span><span data-if="c" style="display:none">set_text_model_param</span><span data-if="cpp" style="display:none">SetTextModelParam</span><span data-if="com" style="display:none">SetTextModelParam</span><span data-if="dotnet" style="display:none">SetTextModelParam</span><span data-if="python" style="display:none">set_text_model_param</span></a></code>, 
<code><a href="text_line_orientation.html"><span data-if="hdevelop" style="display:inline">text_line_orientation</span><span data-if="c" style="display:none">text_line_orientation</span><span data-if="cpp" style="display:none">TextLineOrientation</span><span data-if="com" style="display:none">TextLineOrientation</span><span data-if="dotnet" style="display:none">TextLineOrientation</span><span data-if="python" style="display:none">text_line_orientation</span></a></code>, 
<code><a href="text_line_slant.html"><span data-if="hdevelop" style="display:inline">text_line_slant</span><span data-if="c" style="display:none">text_line_slant</span><span data-if="cpp" style="display:none">TextLineSlant</span><span data-if="com" style="display:none">TextLineSlant</span><span data-if="dotnet" style="display:none">TextLineSlant</span><span data-if="python" style="display:none">text_line_slant</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="get_text_result.html"><span data-if="hdevelop" style="display:inline">get_text_result</span><span data-if="c" style="display:none">get_text_result</span><span data-if="cpp" style="display:none">GetTextResult</span><span data-if="com" style="display:none">GetTextResult</span><span data-if="dotnet" style="display:none">GetTextResult</span><span data-if="python" style="display:none">get_text_result</span></a></code>, 
<code><a href="get_text_object.html"><span data-if="hdevelop" style="display:inline">get_text_object</span><span data-if="c" style="display:none">get_text_object</span><span data-if="cpp" style="display:none">GetTextObject</span><span data-if="com" style="display:none">GetTextObject</span><span data-if="dotnet" style="display:none">GetTextObject</span><span data-if="python" style="display:none">get_text_object</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
OCR/OCV</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
